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Research  Summary 

PCDANGER  is  a  personal  computer  application  of  the 
National  Fire  Danger  Rating  System  (NFDRS)  that  cal- 
culates both  1 978  and  1 988  version  fire  danger  indexes 
from  daily  weather  observations  and  forecasts.  Its  com- 
putational routines  (NFDRCALC)  are  the  same  as  those 
used  in  the  Weather  Information  Management  System 
(WIMS),  which  is  the  current  national  system  in  the 
United  States  for  daily  computation  of  NFDRS  compo- 
nents and  indexes.  PCDANGER  replaces  the  former 
PC-based  fire  danger  rating  application  NFDRSPC. 


Although  PCDANGER  does  not  provide  some  of  the 
important  features  available  through  WIMS,  it  does  pro- 
vide added  local  flexibility  in  computing  and  graphing 
fire  danger-rating  indexes  for  a  small  set  of  fire  weather 
stations.  It  does  not  automatically  interface  with  the 
National  Interagency  Fire  Management  Integrated  Data- 
base (NIFMID),  or  the  National  Weather  Service's  Tele- 
communications Gateway.  Therefore,  it  must  not  be 
seen  as  a  substitute  for  WIMS.  It  allows  WIMS  users  to 
compute  independent  NFDR  index  values  from  the 
same  fire  weather  observations  without  cost  or  risk  of 
corrupting  the  NIFMID  database.  This  feature  is  useful 
for  both  troubleshooting  index  values  and  for  NFDR 
training  sessions  where  access  to  WIMS  is  not  feasible. 
It  is  an  excellent  tool  to  evaluate  the  sensitivity  of  NFDR 
indexes  to  different  weather  parameters.  PCDANGER 
also  allows  the  user  to  forecast  NFDR  indexes  beyond 
the  next-day  limit  in  WIMS,  a  helpful  feature  in  developing 
weather  scenarios. 

Contents 

Page 


Introduction  1 

Installation  2 

Getting  Started  2 

The  Station  Catalog  2 

Weather  Observations  5 

Forecast  Indexes  7 

View  Archived  Weather  Observations,  Indexes, 

and  Forecasts  9 

System  Utilities  10 

References  1 1 

Appendix  A:  Weather  Files  12 

Appendix  B:  PCDANGER  Data  Files  and 

File  Formats  13 

Appendix  C:  Programs  Using  Historical  Fire  and 

Weather  Information  14 

Appendix  D:  PCDANGER  Source  Code  15 

Appendix  E:  Software  Availability  16 


The  use  of  trade  or  firm  names  in  thiis  publication  is  for  reader  information  and  does  not 
imply  endorsement  by  the  U.  S.  Department  of  Agriculture  of  any  product  or  service. 


Intermountain  Research  Station 
324  25th  Street 
Ogden,  UT  84401 


User's  Guide  to  PCDANGER: 
National  Fire  Danger  Rating 
System  for  Personal  Computers 

Larry  S.  Bradshaw 
Erin  M.  Law 

"Our  danger  measuring  system 
may  have  its  weak  spots  but  the 
best  watch  in  the  world  will  not 
show  time  accurately  if  you  do  not 
wind  it." 

H.  T.  Gisbome,  1948 

"What's  'to  wind  a  watch'?" 

Anonymous  school  child,  1994 


Introduction  

Among  the  risks  facing  fire  management  in  the 
"information  age"  is  the  seduction  of  the  fire  manager 
by  technology.  As  we  attempt  to  keep  pace  with  the 
rising  stakes  of  risk  exposure,  the  tools  we  develop 
exhibit  a  corresponding  increase  in  complexity.  An 
unfortunate  side  effect  of  this  trend  is  the  increasing 
commitment  of  time  to  master  these  tools,  time  which 
might  better  be  spent  in  the  field.  Equally  dangerous 
is  the  surreptitious  desire  that  mastery  of  the  tools 
might  substitute  for  field  experience. 

Happily,  this  program  opposes  that  trend.  Interpre- 
tation of  the  components  and  indexes  of  the  National 
Fire  Danger  Rating  System  (NFDRS)  has  evolved  in 
concert  with  our  imderstainding  of  fire  in  the  human 
environment.  From  interagency  staffing  levels  in  sup- 
pression planning  to  guidelines  for  natural  fire  pre- 
scriptions, most  fire  managers  work  with  the  NFDRS 
every  day.  PCDANGER  with  its  menu-driven  for- 
mat— which  replaces  the  former  PC-based  applica- 
tion, NFDRSPC — has  made  calculating  the  indexes 
easier  than  taking  the  weather. 

Several  programs  exist  that  calculate  the  NFDRS 
indexes  from  daily  and  historical  weather  data  (ap- 
pendix C).  The  computational  routines  used  by  the 
program  NFDRCALC  (appendix  D)  are  used  by  both 
PCDANGER  and  the  Weather  Information  Manage- 
ment System  (WIMS)  (USDA  Forest  Service  1995) 
housed  at  the  National  Computer  Center  in  Kansas 


City,  MO.  They  also  form  the  basis  of  several  commer- 
cially available  fire  weather  systems. 

Although  PCDANGER  does  not  provide  some  of 
the  important  features  available  through  WIMS,  it 
does  provide  local  flexibility  in  computing  and  graph- 
ing fire  danger-rating  indexes.  It  does  not  automati- 
cally interface  with  the  National  Interagency  Fire 
Management  Integrated  Database  (NIFMID)  or  the 
National  Weather  Service's  Telecommunications  Gate- 
way. Therefore,  it  must  not  be  seen  as  a  substitute  for 
WIMS.  PCDANGER  was  designed  to  accommodate 
the  daily  danger-rating  activities  of  a  small  (up  to  32) 
set  of  weather  stations.  It  computes  fire  danger  in- 
dexes for  both  the  1978  and  1988  versions  of  the 
NFDRS;  you  may  select  either  or  both.  Although  it 
does  not  allow  for  Special  Interest  Groups  (SIGs)  or 
are  a- weighting  of  stations,  it  enables  the  user  to  fore- 
cast fire-danger  indexes  for  any  number  of  days,  to 
graph  the  observed  weather,  and  to  compute  and 
forecast  indexes. 

By  necessity,  PCDANGER  assumes  that  the  user 
has  a  basic  understanding  of  the  DOS  computer  oper- 
ating system.  If  you  have  an  IBM-compatible  com- 
puter and  can  copy  a  file,  you  will  have  no  problem 
installing  PCDANGER  and  operating  this  program. 
Likewise,  PCDANGER  assumes  the  user  is  familiar 
with  the  NFDRS .  Though  the  help  screens  are  compre- 
hensive, the  program  cannot  interpret  the  compo- 
nents and  indexes  for  you. 
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Installation 


The  Main  Menu 


Installation  of  the  PCDANGER  program  requires 
about  one  free  megabyte  on  the  hard  drive  and  about 
600K  memory.  The  following  is  an  example  of  how 
you  might  do  the  installation  in  DOS.  Bold  type  indi- 
cates your  key  entries.  You  may  use  the  Window  File 
Manager,  or  Windows  95  Explorer  to  do  the  equivalent 
in  Windows. 

1.  Create  a  directory  on  the  hard  drive  for  the 
program.  'FDR'  is  short  and  sweet,  and  we  will  use 
it  for  the  purposes  of  this  user's  guide. 

Type  and  enter  each  command: 
MD  \FDR 
CD  \FDR 

2.  Copy  the  file  FDR_SEND.EXE  from  the  install 
disk  (A:)  into  the  directory.  This  is  a  self-extract- 
ing  file  (in  other  words,  a  compressed  file  that 
automatically  expands). 

Type  and  enter: 

Copy  A:FDR_SEND.EXE 

3.  Extract  the  program  files. 
Type  and  enter: 
FDR_SEND 

The  program  files  are  expanded  and  installation  is 
complete. 

4.  If  you  wish,  you  may  delete  FDR_SEND.EXE 
from  the  hard  drive. 

Type  and  enter: 

DEL  FDR  SEND.EXE 


Getting  Started 


To  start  the  program,  type  PCDANGER  from  the 
FDR  directory.  For  convenience,  you  may  rename  the 
executable  file  'FDR'  or  some  other  abbreviation  to 
shorten  the  command  keystrokes. 

Type  and  enter: 

REN  PCDANGER.EXE  FDR.EXE 


Key  Functions 

J  Enter 

T  Up  arrow 
i  Down  arrow 
—y  Right  arrow 
i—  Left  arrow 
Page  Down 

Page  Up 

Esc 

Fl 

Shift  Fl 
Shift  F2 


Accepts  field  entry  and  advances 
cursor  to  next  field. 
Previous  field. 
Next  field. 

Next  space  within  field. 
Previous  space  within  field. 
Next  station  catalog  (does  not 
save  changes). 

Previous  station  catalog  (does 

not  save  changes). 

Back    out   without  saving 

changes. 

Process  entries  (save  changes). 
Help. 

Index  of  input  options. 


The  PCDANGER  main  menu  screen  is  illustrated  in 
figure  1.  Because  the  NFDRS  computes  components 
and  indexes  from  weather  observed  regularly  at  fixed 
locations,  the  station  location  must  be  described  be- 
fore recording  weather  observations.  This  description 
is  called  the  station  catalog.  To  bring  the  station 
catalog  to  the  screen  from  the  main  menu,  choose  6. 
Enter  Catalog  Information. 

Note:  If  you  will  be  entering  weather  observations 
for  more  than  one  station,  the  program  will  present  the 
stations  to  you  in  the  order  that  they  were  initially 
cataloged.  If  you  are  going  to  designate  one  of  your 
stations  as  an  associated  station,  the  associated  sta- 
tion must  be  cataloged  before  the  station  that  wall 
borrow  its  observation  (see  discussion  of  associated 
stations). 

To  choose  any  of  the  eight  options  in  the  main  menu, 
you  may  either  scroll  down  with  the  arrow  key,  or 
enter  the  number  of  the  option  you  wish  to  choose,  and 
press  Enter. 

The  Station  Catalog   


The  station  catalog  screen  is  shown  in  figure  2. 
Each  gray  block  where  information  can  be  entered  is 
called  a  field.  The  gray  bar  across  the  bottom  of  the 
screen  displays  field  prompt  messages.  These  give 
brief  hints  about  the  information  to  be  entered  and  its 
correct  format.  Error  and  information  messages  will 
appear  below  the  field  prompts.  Some  fields  are  vali- 
dated and  will  not  let  you  exit  (forward  or  back) 
without  a  valid  entry.  If  you  are  in  a  validated  field 
and  can't  back  up  to  a  previous  field,  try  putting  a 
valid  entry  in  the  field  and  hit  the  up  arrow  key. 

The  station  catalog  describes  the  station's  physical 
location  and  the  representative  fuels  for  the  fire  dan- 
ger rating  area.  Most  danger-rating  model  assump- 
tions and  interrelationships  are  discussed  in  the 
Help  screens  to  assist  with  decisions  between  options 
and  initialization  values. 

PCDANGER  uses  the  station  name  as  the  pri- 
mary reference  for  the  weather  station.  The  station 
number  (ID)  is  associated  with  the  name.  If  you  are 
working  with  national  fire  weather  network  stations, 
use  the  assigned  network  number.  If  you  are  not 
working  with  established  stations,  you  may  assign 
any  number  you  wish.  If  you  enter  the  name  of  a 
station  that  is  already  in  the  catalog  file,  you  will 
receive  a  message  informing  you  that  the  station 
name  already  exists.  You  must  enter  a  new  name.  If 
you  wish  to  view  a  list  of  stations  already  cataloged, 
press  Shift  F2  (Index).  If  you  would  like  to  view  or 
change  the  catalog  information  for  the  station  that  you 
just  tried  to  reenter,  you  must  Escape  to  the  main 
menu  and  press  7.  View/Edit  Catalog  Information. 
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Figure  1 — PCDANGER  Main  Menu.  Note  that  current  catalog  is 
PCDANGER.CAT. 
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Figure  2— Tine  station  catalog  screen  (Option  6.  of  the  Main  Menu), 
showing  default  entries  and  the  field  message  at  the  bottom  of  the  screen 
for  the  name  field. 
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Any  entry  in  the  RAWS  ID  field  other  than  MANUAL 
STN  will  access  the  Assoc  Sin  (Associated  Station) 
field.  Designate  an  associated  station  to  provide 
inputs  for  those  weather  variables  that  are  not  meas- 
ured by  your  remote  instrumentation,  such  as  the 
state  of  the  weather  or  the  measured  10-h  fuel  mois- 
ture value .  When  weather  observations  for  the  present 
station  are  entered,  the  program  will  pull  associated 
observations  fi-om  the  station  that  you  designate  here 
and  mark  them  with  an  asterisk.  The  station  fi-om 
which  you  wish  to  pull  the  observations  must  already 
exist  in  the  catalog.  When  entering  today's  observa- 
tions for  a  number  of  stations,  the  program  presents 
the  stations  to  you  in  the  order  in  which  they  were 
cataloged.  This  ensures  that  current  weather  observa- 
tions will  have  been  entered  for  the  associated  station 
before  the  present  station  uses  them. 

Default  values  for  certain  fields  are  entered  for  you. 
While  these  values  enable  program  operation,  to  have 
relevance,  the  entries  must  be  site-specific.  For  exam- 
ple, the  default  station  Latitude  is  the  geographic 
center  of  the  continental  United  States.  However,  lati- 
tude contributes  to  the  computation  of  day  length, 
used  in  turn  to  calculate  the  large  fuel  moistures.  The 
effects  of  using  default  values  may  not  be  noticeable 
on  components  and  indexes  weighted  primarily  to- 
ward daily  observations  (spread  component  or  ignition 
component).  However,  the  difference  can  be  signifi- 
cant in  the  energy  release  component  (ERC),  which 


reflects  seasonal  trends  through  the  100-h  and  1,000-h 
fuel  moistures  (Burgan  1976). 

Up  to  four  fuel  models  may  be  defined  per  station, 
from  either  the  1978  or  1988  NFDRS.  Not  all  fields  are 
mandatory  for  each  fuel  model  set.  Prompt  messages 
indicate  which  fields  are  required  for  which  version. 
You  also  have  the  option  to  designate  all  the  attributes 
of  the  fuel  model,  but  leave  the  fuel  model  field  blank. 
This  has  the  effect  of  turning  off"  the  index  calculations 
for  that  model  without  having  to  delete  all  its  attri- 
butes. If  you  do  designate  the  parameters  for  a  blank 
fuel  model  field,  you  will  receive  a  message:  "NFDR  not 
computed  for  this  line.  Other  values  intact."  Because 
the  indexes  are  fuel-model  specific,  changing  the  fuel 
model  in  a  station  catalog  reinitializes  all  calculations 
for  that  model.  For  complete  narrative  descriptions  of 
the  1978  fuel  models,  see  Deeming  and  others  (1977, 
p.  32).  For  comparison  of  the  1978  and  1988  fuel 
model  parameters,  see  Burgan  (1988,  pp.  21,  22). 

Designating  the  current  vegetation  stage  (Veg  Stg) 
for  1978  fuel  models  is  mandatory.  After  a  weather 
record  has  been  established,  the  current  stage  of  the 
vegetation  is  shown  in  the  index  display  as  a  letter 
following  the  herbaceous  fuel  moisture  (Pregreenup 
[PRE],  Greenup  [GRN],  Transition  [TRN],  Cured 
[CUR] ,  or  Frozen  [FRE] ) .  The  vegetation  stage  display 
is  illustrated  in  figure  3  for  the  two  1978  fuel  models 
under  the  column  labeled  "HRB . "  As  you  enter  weather 
observations  through  the  season,  you  will  receive 
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Figure  3 — Completed  observation  entry  with  computed  indexes.  Some  values 
which  do  not  change  between  models  are  not  repeated  down  the  column.  The 
menu  bar  at  the  bottom  and  the  menu  prompt  direct  your  next  move. 
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messages  informing  you  that  greenup  and  curing  are 
complete  for  your  1978  fuel  models.  Ifyou  want  to  force 
greenup,  enter  the  vegetation  stage  as  green  (GRN). 
The  program  will  prompt  you  to  specify  the  greenup 
date,  taking  the  current  system  date  as  the  default.  It 
will  then  verify  the  date  you  specify  as  the  greenup 
date  for  any  additional  1978  fuel  models  in  the  current 
station. 

Selection  of  a  Staffing  Index  upon  which  to  base 
staffing  classes  is  optional,  but  if  an  index  is  desig- 
nated, assigning  the  number  of  staffing  classes  (#  Cls) 
and  the  values  at  the  breakpoint  percentiles  (1st  and 
2nd)  is  mandatory.  When  a  staffing  class  index  has 
been  designated,  it  is  displayed  followed  by  a  #  (see 
display  of  ERG,  fig.  3). 


Entries  in  the  station  catalog  fields  will  be  saved 
only  if  you  hit  Fl  or  fill  out  the  entire  screen  and 
answer  'Y'  to  the  final  execute  prompt.  Ifyou  answer 
no  (N)  to  the  execute  prompt,  all  of  the  information  in 
the  fields  will  be  erased,  and  the  cursor  will  return  to 
the  Name  field  at  the  top  of  the  screen.  You  may 
Escape  out  of  the  screen  at  any  time,  and  none  of  the 
entries  will  be  saved.  This  also  applies  when  making 
edits  to  the  station  catalog:  if  you  make  changes  to  the 
catalog  information,  those  changes  will  be  saved  only 
if  you  hit  Fl  or  scroll  through  the  entire  screen  and 
answer  yes  to  execute.  When  the  execute  command  is 
processed,  a  message  will  indicate  that  the  station 
catalog  has  been  added  or  updated.  Press  Escape  to 
return  to  the  main  menu.  A  completed  catalog  screen 
is  illustrated  in  figure  4. 

For  thorough  discussions  of  the  NFDRS  fuel  models, 
see  Deeming  and  others  (1977),  Bradshaw  and  others 
(1983),  and  Burgan(1988).  For  a  more  complete  expla- 
nation of  weather  station  set-up  and  maintenance,  see 
Fischer  and  Hardy  (1976)  and  Finklin  and  Fischer 
(1990). 


Weather  Observations   

After  the  weather  station  catalog  has  been  estab- 
lished, weather  observations  for  that  station  may  be 
entered.  This  can  be  accomplished  either  manually 
from  the  keyboard  or  by  reading  observations  from  a 
data  file. 

Entering  observations  from  the  keyboard:  From 
the  main  menu,  enter  1.  Enter  Observations  and 
select  KEYBOARD  from  the  pop-up  menu. 

Entering  observations  from  a  weather  data 
file:  From  the  main  menu,  enter  1.  Enter  Observa- 
tions and  select  NIFMID  or  AFFIRMS  from  the  pop- 
up menu. 

Selecting  NIFMID  or  AFFIRMS  tells  the  program  to 
look  for  a  weather  file  of  the  specified  format  from 
which  to  pull  observation  data.  This  file  must  reside  in 
the  same  directory  as  the  PCDANGER  program  (such 
as  C:\FDR\101028.FWX;  for  information  regarding 
data  file  naming  conventions  and  formatting  stan- 
dards, see  appendix  A).  When  the  program  finds  the 
file,  it  displays  a  message  below  the  station  name  to 
indicate  which  file  is  in  use  (fig.  3). 

Once  you  have  selected  the  method  of  entering 
weather  observation  data,  you  are  presented  with  the 
observation  entry  screen  (fig.  5).  The  first  station  in 
the  catalog  is  the  default  station  on  the  screen.  The 
Page  Up/Page  Down  keys  enable  you  to  scroll  through 
stations,  or  the  index  (Shift  F2)  can  provide  you  with 
a  complete  list  fi-om  which  to  choose.  After  selecting  a 
station,  the  station  ID  number  is  shown  in  paren- 
theses. The  program  displays  the  date  of  the  station's 
last  archived  weather  observation  to  the  right  of  the 
station  ID.  In  figure  5,  none  have  been  archived  yet 
(00/00/00).  Once  an  archived  weather  record  has  been 
established,  the  date  following  the  last  archived  obser- 
vation is  provided  as  the  default  observation  date. 

Ifyou  read  data  from  a  file,  the  field  values  will  be 
filled  in  for  you  when  you  specify  the  date.  When 
entering  observations  manually,  help  screens  (Shift 
Fl)  and  an  index  of  valid  entries  (Shift  F2)  are  avail- 
able to  assist  with  input. 

The  first  observation  date  entry  produces  a  prompt 
message  stating  "yesterday's  observation  not  found, 
no  persistence  applied."  During  subsequent  data  entry 
sessions,  this  message  alerts  you  that  an  interruption 
has  occurred  in  the  continuity  of  your  weather  record. 
As  long  as  your  weather  records  are  continuous, 
PCDANGER  will  carry  forward  several  fields  that 
change  little  from  day  to  day,  such  as  LAL  (Lightning 
Activity  Level),  risk  factors,  state  of  the  weather,  and 
greenness  factors.  Any  interruption  of  more  than  30 
days  will  reinitialize  all  NFDRS  calculations. 

The  program  will  cross-check  certain  values  for 
consistency;  for  example,  it  will  not  allow  input  of  a 
maximum  relative  humidity  value  that  is  lower  than 


Note:  Computation  of  the  Staffing  Class  (SC), 
Adjective  Rating  (R)  and  the  R6  Industrial  Precau- 
tions Class  (PC)  are  based  on  the  same  criteria  as  in 
WIMS.  These  are  docvunented  in  the  WIMS  User's 
Guide  (USD A  Forest  Service  1995,  appendix  E),  and 
the  AFFIRMS  Manual  (Helfman  and  others  1987, 
appendix  F).  Standard  methods  for  computing  per- 
centiles upon  which  to  base  staffing  classes  is  docu- 
mented in  the  FIREFAMILY 1988  (Main  and  others 
1990)  and  KCFAST  (USDA  Forest  Service  1996a) 
publications.  Since  the  FIREFAMILY  1988  pubHca- 
tion,  a  PC  version  of  FIREFAMILY  (California  De- 
partment of  Forestry  1994)  has  greatly  simplified 
this  process.  Current  work  at  the  Intermountain 
Fire  Sciences  Laboratory  (FIRES:  a  program  for  fire 
danger  rating  analysis.  Andrews  and  Bradshaw 
1997)  provides  improved  methods  for  staffing  class 
determination,  and  processing  systems  will  likely 
be  modified  to  reflect  these  changes. 
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12/14/95     5:55  P 

Name  MOOSE,  CREEK  ID  ^AUS  ID  ^^^^   Region  ^  Unit  |^ 

Latitude    I        \      Longitude  ^  Elevation  FUX  Zone  Hf^ 

Agency  |     Time  Zone  |     Humidity  Type  |     100-Hour  ^        1000-Hour  ^ 
Assoc  Stn  2  Lightning  RSF  Aspect 


1000-Hour  *j 


I     Stick  Date  Annual  Precipitation 

I   Obser^^ation  Time  ^     Fire  Season  BHHHHHIii 


Site  I  Woody  F.M. 
Keetcli-Byram 


Mdl     Sip    Grass    Clim   Ueg    Shrub    l-h=     —  Staffing  Info  — 
Model    Sys     Cls    Type     Cls     Stg    Type     10-h     Index   B  Cls    1st  2nd 

111113     a   nil     I  ^  ^  ^ 


.ast  Observation:  08/04/94 
Joody  Date  :  00/00/00 


(Fl=Process/  ESC=CanceI) 
(Shift  Fl=Help) 


reenup  Date(s)  :  1-(0415),  2-(0415),  3-(n/a  ).  4-(n/a  ) 


Station  Kane  (ESC=Return 

PgUp/PgDn=Freu/Next  Station  Shift  FZ=Index} 

Figure  4 — Completed  station  catalog  screen.  Note  that  green-up  date  is  not 
specified  for  1988  fuel  model  system. 


the  current  relative  humidity.  If  you  enter  an  unrea- 
sonable value,  the  cursor  will  jump  back  to  the  initial 
entry  (in  this  case,  the  relative  humidity  field)  and 
offer  you  the  opportunity  to  correct  it.  After  confirming 
the  relative  humidity  value,  the  cursor  returns  to  the 
maximum  humidity  field.  For  optional  data  fields, 
PCDANGER  will  allow  blanks. 

When  the  weather  input  is  complete,  either  press 
'enter'  following  input  of  the  season  code,  or  press  Fl 
from  anyw^here  in  a  completed  screen.  The  NFDRS 
components  and  indexes  are  calculated  and  displayed 
across  the  bottom  third  of  the  screen,  along  with  a 
menu  bar  that  guides  your  next  step.  A  completed 
observation  screen  with  NFDR  components  is  shown 
in  figure  3. 

The  cursor  is  now  positioned  in  the  menu  bar  at  the 
bottom  of  the  screen.  From  here  you  may  proceed  in 
one  of  five  directions: 

Return — archives  the  observation  that  you  have 
just  completed,  and  returns  you  to  the 
main  menu. 
Edit — allows  you  to  edit  the  current  observa- 
tion fields. 

Day —  archives  the  observation  that  you  have 
just  entered,  and  returns  you  to  the  top 
of  a  new  observation  screen  for  the  same 
station,  the  following  day. 


Station — archives  the  observation  that  you  have 
just  completed  and  returns  you  to  the 
top  of  a  new  observation  screen  for  the 
same  day,  for  next  station  in  the  catalog. 

Cancel — does  not  archive  the  current  observation 
screen,  and  returns  you  to  the  main 
menu. 

Column  heading  abbreviations  for  the  index  display 
are  as  follows: 


Y 

Model  year 

M 

Fuel  model 

S 

Slope  class 

G 

Grass  type 

C 

Climate  class 

S 

Shrub  type 

WDY 

Woody  fuel  moisture 

HRB 

Herbaceous  fuel  moisture 

IH 

1-hour  fuel  moisture 

10 

10-hour  fuel  moisture 

HU 

100-hour  fuel  moisture 

TH 

1,000-hour  fuel  moisture 

KDI 

Keetch-Byram  Drought  Index 

IC 

Ignition  component 

LR 

Lightning  risk 

LOI 

Lightning  fire  occurrence  index 

HR 

Human-caused  risk 

HOI 

Human-caused  fire  occurrence  index 
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Fire  Weather  OBSERUATION  For  ^ 
Obs  Date  810188       Obs  Time 

Temperature 


Uiiid  Direction 
Forecast  HCR 
Max.  Rel.  Hum. 
Precip.  Amount 
Herb.  Green.  Fact, 


Humidity  Uar. 
Uind  Speed 
Max.  Temperature 
Min.  Rel.  Hum., 
Morning  LAL 
Uoody  Green.  Fact. 


2/87/95     5:88  F 
(181828)    Last  Ob  =  88/88/88 

State  of  Weather  | 

le-Hour  Fuel  Stick 

Human-Caused  Risk 

Min.  Temperature  '''^^ 

Precip.  Duration 

I      Yesterday's  LAL  | 

Season  Code  I 


»»»    (Fl=Process  NFDR  /  ESC=Cancel  /  Shift  Fl=Help  /  Shift  F2=lndex)  »»» 


Date  of  Observation  (MIIDDyy) 

Figure  5 — Example  of  an  initial  weather  observation  screen.  The  cursor  is 
positioned  on  the  Obs  Date  field,  and  the  field  prompt  message  at  the  bottom  of 
the  screen  indicates  the  correct  date  format. 


SC  Spread  component 

ERC  Energy  release  component 

BI  Burning  index 

FLI  Fire  load  index 

SC  Staffing  class 

R  Adjective  fire  danger  rating 

PC  Industrial  precautions  class 

Editing  archived  observations:  PCDANGER  al- 
lows you  to  edit  previously  entered  fire  weather  ob- 
servations and  recalculate  indexes  fi*om  the  edited 
date  through  the  most  recent  archived  observation.  To 
edit  an  archived  observation,  fi-om  the  main  menu, 
enter  2.  Edit  Archived  Observations. 

The  edit  observation  screen  is  the  same  as  the  enter 
observation  screen  (fig.  5).  First  select  the  station, 
then  the  date  of  the  observation  to  be  edited.  The 
observation  for  that  date  will  be  displayed  on  the 
screen  for  editing.  When  you  have  completed  your 
edits,  press  Fl  (process)  and  the  new  NFDR  indexes 
are  displayed  across  the  bottom  portion  of  the  screen. 
You  will  then  be  given  the  option  of  recalculating  daily 
indexes  from  the  currently  edited  day  forward. 

Forecast  Indexes  

You  may  enter  forecasted  weather  values  or  trends 
in  order  to  forecast  NFDRS  components  and  indexes. 


From  the  main  menu,  press  3.  Enter  Forecasts  to 

access  the  forecast  screen. 

The  program  assumes  the  forecast  date  to  be  tomor- 
row. After  specifying  the  station  and  accepting  the 
date  (press  Enter),  the  program  displays  today's 
observations  across  the  bottom  of  the  screen,  as  illus- 
trated in  figure  6.  You  may  input  actual  values  fore- 
cast for  tomorrow's  weather,  or  you  may  enter  a  trend 
oi+x  or  -X,  where  x  is  the  number  of  units  change  for 
that  variable.  The  -i-  or  -  specifies  that  a  trend  is  to  be 
projected.  For  example,  entering  -i-5  in  the  tempera- 
ture field  indicates  that  tomorrow's  temperature  will 
be  5°  higher  than  today's,  whereas  just  entering  5  in 
the  temperature  field  indicates  that  tomorrow's  tem- 
perature will  be  5°.  A  persistence  forecast  can  be 
entered  as  either  -i-O  or  -0.  Once  the  required  fields  are 
entered  or  Fl  is  pressed,  the  forecast  weather  is 
processed  and  the  forecast  NFDR  indexes  are  dis- 
played on  the  bottom  portion  of  the  screen  (fig.  7). 

The  forecast  module  aUows  you  to  forecast  the  NFDRS 
indexes  for  an  unlimited  number  of  days.  As  in  the 
observation  screen,  the  menu  bar  at  the  bottom  of  the 
screen  controls  the  next  step.  'Return',  'Day',  and 
'Station'  archive  the  forecast.  'Edit'  and  'Cancel'  do  not. 
If  you  select  'Dajr*,  you  may  build  on  the  present 
forecast  and  project  another  day  out. 
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Fire  Heather  FORECAST  For 


Fcst  Date  . 
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Max .  Re  1 .  Hum . 
Precip.  Amount 
Herb.  Green.  Fact,  i 
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'fine  ^orecttst  is  gan<i.  Resrest  tiDur, 


Figure  6 — Empty  forecast  entry  screen,  showing  display  of  today's  observation 
in  the  bottom  portion  of  the  screen.  Note  that  the  herbaceous  and  woody 
greenness  factors  (Fh  and  Fw  in  observation  display)  are  carried  fonward  for  you. 
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tt  Denotes  Staffing  Index 


Figure  7 — ^Trend  forecast  entry  that  shows  a  2  °F  increase  in  tomorrow's 
observation  time  temperature,  and  a  5  percent  decrease  in  relative  humidity. 
Resulting  forecast  indexes  are  displayed  across  bottom  third  of  screen. 
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View  Archived  Weather 
Observations,  Indexes,  and 
Forecasts  

PCDANGER  provides  three  formats  to  view 
archived  data:  (1)  tabular  by  date,  sorted  by  station, 
(2)  tabular  by  station,  sorted  by  date,  and  (3)  graphi- 
cally. From  the  main  menu,  select  'Tables'. 

Tables 

Selecting  1.  View  Indexes  in  Tabular  Format, 
Ordered  by  Date,  gives  you  a  table  of  indexes  for  all 
stations  sorted  by  date,  with  a  secondary  sort  by 
station.  A  submenu  asks  you  to  specify  which  dates 
you  would  like  to  see.  All  dates  is  the  default. 

Selecting  2.  View  Indexes  in  Tabular  Format, 
Ordered  by  Station,  gives  you  a  table  of  indexes  for 
all  dates  sorted  by  station.  A  submenu  asks  you  to 
specify  which  stations  you  would  like  to  see.  All 
stations  is  the  default.  An  example  of  a  tabular 
display  of  indexes  ordered  by  station  is  shown  in 


figure  8.  The  tabular  display  of  weather  observations 
is  similar. 

Graphs 

Selecting  3.  View  Indexes  in  Graphic  Format, 

allows  you  to  graph  your  archived  indexes  by  specify- 
ing graph  display  parameters  (fig.  9).  In  this  screen 
you  may  specify  up  to  four  variables  to  graph.  Select 
any  stations  for  which  you  have  archived  indexes. 
You  may  specify  whether  to  display  lines  representing 
the  Level  1  and  2  percentile  values  as  defined  in  the 
station  catalog  for  each  station/model/index  combina- 
tion. In  the  Model  field,  use  the  index  function  (Shift 
F2)  to  enter  valid  model  configurations  for  the  speci- 
fied station.  Any  of  the  NFDRS  calculated  compo- 
nents, indexes,  or  fuel  moistures  are  available  for 
display.  The  Plot  field  allows  you  to  toggle  any  of 
the  four  lines  on  or  off.  Your  commonly  graphed 
configurations  can  be  saved  by  answering  'y'  to  the 
'Update  Configuration  File'  prompt  and  entering  a 
meaningful  file  name  in  the  Save  As  field.  These  can 
later  be  retrieved  using  the  index  function  (Shift  F2). 
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Figure  8— An  example  of  indexes  displayed  in  tabular  format  ordered  by  station. 
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Figure  9 — The  screen  in  which  you  specify  which  variables  you  would  like  to  graph. 


Once  you  have  set  the  graph  parameters,  pressing 
Fl  will  display  the  graph  as  illustrated  in  figure  10. 
A  menu  bar  at  the  top  of  the  screen  lets  you  print 
the  graph  or  return  to  the  graph  parameter  screen. 
Return  is  the  default.  If  you  receive  the  message 
'Problem:  No  Records  Selected...',  you  have  selected  a 
station  that  has  no  archived  records  of  the  type  speci- 
fied in  the  graph  parameter  setup. 

If  you  want  to  print  the  graph,  select  Print  from  the 
menu  bar.  If  your  printer  has  not  been  configured,  the 
program  will  ask  you  for  the  proper  settings  (see  note 
under  system  utilities  regarding  printer  configuration 
and  parameters).  If  you  do  not  know  which  port  you 
are  set  up  for,  LPTl  is  usually  a  good  guess.  If  your 
first  choice  is  incorrect,  the  program  will  give  you  the 
message  that  your  printer  is  offline.  Check  the  printer 
to  ensure  that  you're  plugged  in,  turned  on,  and 
connected.  If  it  is  not  offline,  change  the  configuration 
to  another  port  through  option  8.  System  Utilities  in 
the  main  menu.  When  using  PCDANGER  in  the  Win- 
dows environment,  using  the  Print  Screen  key  to 
capture  the  screen  image  to  a  bitmap  on  the  clipboard 
works  well.  The  image  can  be  pasted  in  your  favorite 
program  and  printed  using  the  Windows  drivers. 

System  Utilities  

1.  Export  Weather  Observations  to  NIFMID/ 
PCFIRDAT  Format:  This  utility  will  create  a  stan- 
dard NIFMID-formatted  file  of  your  archived  weather 


observations  for  selected  stations.  A  pop-up  menu  will 
prompt  you  for  the  new  file  name.  The  file  will  be 
sorted  by  station  number  +  date.  The  data  format  is 
illustrated  in  appendix  B. 

2.  Export  NFDR  Indexes  to  a  File:  This  utility 
will  create  a  file  of  your  archived  indexes  for  selected 
stations.  A  pop-up  menu  will  prompt  you  to  specify 
the  new  file  name.  The  file  will  be  sorted  by  station 
number  +  date.  The  data  format  is  illustrated  in 
appendix  B. 

3.  Set-up  Printer  Configuration  for  Graphics 
Output:  Printer  set-up  is  a  quick  utility  that  asks 
you  for  the  information  that  PCDANGER  needs  to 
properly  configure  your  printer.  It  asks  for:  ( 1 )  the  type 
of  printer,  (2)  which  direction  to  orient  the  paper,  and 
(3)  printer  port. 

Note:  The  graphics  printer  utility  used  in  PC- 
DANGER  is  a  primitive  tool.  Experience  has  shown 
that  lower  density  print  selection  prints  much  faster 
and  many  times  better  than  the  higher  density  selec- 
tions, particularly  on  the  laser  printers.  For  nonlaser 
printers  you'll  have  to  experiment  for  the  best  results 
if  exact  matches  are  not  in  the  printer  list. 

4.  Create  an  Empty  Station  Catalog  File:  This 
utility  allows  you  to  create  a  file  to  house  another  32- 
station  catalog.  To  do  so,  simply  type  the  name  (using 
standard  DOS  file-naming  conventions)  of  the  new  cata- 
log file  at  the  prompt.  To  start  the  program  with  the 
new  catalog,  at  the  DOS  command  prompt  in  the  FDR 
directory,  type  PCDANGER  newfile,  where  newfile 
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Figure  10 — Graph  for  the  West  Fork  station  from  the  parameters  illustrated 
in  figure  9.  The  horizontal  lines  are  the  90th  and  97th  percentile  ERC's  defined 
in  the  station  catalog.  The  left  y-axis  (1 )  corresponds  to  ERC,  as  indicated  in  the 
legend,  and  the  right  y-axis  (2)  scales  FM_1000. 


is  the  file  name  of  yovir  new  catalog.  The  main  menu 
title  bar  verifies  the  name  of  the  catalog  file  in  use. 

5.  Shell  to  DOS:  Memory  permitting,  you  will  be 
put  in  a  DOS  shell  with  your  standard  DOS  prompt. 
When  finished  working  in  DOS,  type  exit  to  return  to 
the  PCDANGER  program. 
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Appendix  A:  Weather  Files 


If  you  plan  to  read  data  from  a  weather  file,  it  is  helpful  to  know  the  date  ranges  for  which  you  have 
observations.  This  ensures  that  the  date  you  enter  in  the  field  exists  in  the  file. 

NIFMID  (National  Integrated  Fire  Management  Interagency  Database) 

If  you  retrieved  your  weather  data  through  WIMS,  your  data  follows  the  NIFMID  format.  PCDANGER  will 
read  a  NIFMID-formatted  data  file  with  the  following  rules: 

1.  The  file  must  reside  in  the  same  directory  as  PCDANGER. 

2.  The  file  must  have  an  '.FWX'  extension. 

3.  The  file  name  must  be  the  six-digit  station  ID  as  defined  in  the  station  catalog  (for  example,  101028. FWX  for 
Moose  Creek). 

4.  The  file  should  have  any  extraneous  header  information  removed.  (The  CLEAN  utiUty  in  KCFAST  will  do  this . ) 

To  read  in  weather  observations  fi-om  a  NIFMID-formatted  file,  select  main  menu  option  1.  Enter  Observa- 
tions and  select  NIFMID  from  the  pop-up  menu.  Select  a  cataloged  station  and  enter  a  date  in  the  weather 
observation  entry  screen.  PCDANGER  will  look  for  that  date  in  the  file  and  load  the  observation  values  into  the 
appropriate  fields. 

AFFIRMS 

The  AFFIRMS  format  is  a  standard  format  that  older  processing  systems  may  generate.  It  is  a  two-record 
format,  for  example: 

DATE  95,04,18 

OBS  101028  13  M  79  32  M  M  225  4  2  48  48  73  25  0  0.00  M  M 
DATE  95,04,19 

OBS  101028  13  M  69  48  M  M  315  3  3  81  47  94  29  0  0.00  M  M 
PCDANGER  will  read  an  AFFIRMS-formatted  data  file  with  the  following  rules: 

1.  The  file  must  reside  in  the  same  directory  as  PCDANGER. 

2.  The  file  must  have  an  '.ADF'  extension. 

3.  The  file  name  must  be  the  six-digit  station  ID  as  defined  in  the  station  catalog  (such  as  10 1028.  ADF  for  Moose 
Creek). 

To  read  in  weather  observations  fi'om  an  AFFIRMS-formatted  file,  select  main  menu  option  1.  Enter 
Observations  and  select  AFFIRMS  from  the  pop-up  menu.  Select  a  cataloged  station  and  enter  a  date  in  the 
weather  observation  entry  screen.  PCDANGER  will  look  for  that  date  in  the  file  and  load  the  observation  values 
into  the  appropriate  fields. 

Obtaining  Fire-Weather  Data  Files 

WIMS  users  have  two  methods  to  obtain  files  containing  fire  weather  observations  for  use  by  the  PCDANGER 
program.  The  preferred  method  is  to  use  the  KCFAST  (USDA  Forest  Service  1996a)  program,  which  submits  a 
batch  ORACLE  query  to  WIMS  and  downloads  NIFMID-formatted  fire  weather  observations.  This  file,  when 
given  a  name  as  described  by  the  aforementioned  NIFMID  file-naming  convention,  can  be  read  directly  by 
PCDANGER. 

An  alternate  method  is  to  use  WIMS  interactively  and  display  observations  (DOBS)  for  a  selected  station  and 
date  range.  The  query  is  then  captured  (WIMS  command  CTRL-F2  on  a  Data  General  terminal,  SHFT-F2  from 
a  PC  terminal)  in  a  WIMS  file  that  is  stored  in  your  PFILE  directory.  This  file  can  be  downloaded  to  your  local 
computer  (PC  or  DG),  but  it  retains  the  same  format  as  seen  on  the  WIMS  screen. 

Included  with  PCDANGER  is  the  utility  program  WIMS2PC.  This  program  will  reformat  a  captured  WIMS 
observation  table  that  has  been  printed  PRINTed  (DG)  or  SENT  (SIMPC)  into  the  NIFMID  data  file  format.  The 
file  can  then  be  read  by  PCDANGER. 

To  use  the  WIMS2PC  utility  program: 

1.  Copy  your  screen-formatted  weather  file  into  the  FDR  directory. 

2.  From  the  DOS  prompt  in  the  FDR  directory,  type  and  enter 

WIMS2PC  wims_file  pc_file 
where:  wims_file  is  the  name  of  the  data  file  from  WIMS,  and 

pc_file  is  of  the  format  NNNNNN.FWX,  where  N...N  is  the  six-digit  ID  number  of  the  weather  station. 
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Appendix  B:  PCDANGER  Data  Files  and  File  Formats 


Archived  weather  and  indexes  are  stored  in  files  named  WEATHER.DAT  and  OBS_NDX.DAT.  These  files 
reside  in  the  same  directory  as  the  program  files. 

Archived  forecast  observation  and  indexes  are  stored  in  files  named  FORECAST.DAT  and  FCST_NDX.DAT. 
These  files  reside  in  the  same  directory  as  the  program  files. 

Standard  NIFMID  weather  observation  file  format  is  as  follows: 

Field  description  Begin  column         End  column 


Station  numbsr 

1 

6 

Year 

7 

8 

Mnnth 

g 

10 

Day 

12 

13 

Uiy  UUlU  IcIlipcidlUic  ^  r) 

1  *f 

1  R 
1  D 

Rplatiwp  hiimiHitv/  ^nprppnt\ 

IIC7IC11IVC7  llUIIIIVJIiy  ^^CILfClliy 

■|7 

19 

Hprhj^ppnii^  nrppnnp^^  fj^ptnr 

20 

22 

Hprhappni     \/pnpts*tinn  rnnHitinn 

£0 

24 

Wi  iman-r»ai  icpH  ricl^ 
rnui  1  idi  1  LfCiuocu  i  ioi\ 

£.0 

97 

\A/inH  Hirpr'tir^n  (fi  r\r\ini\ 
VvlllU  UlIcUUUII  [JUIIIl^ 

OH 

Windspeed  (mph) 

29 

31 

Woody  vegetation  condition 

32 

lO-tir  fuel  moisture  (percent) 

33 

35 

Woody  greenness  factor 

36 

38 

IVlaximum  temperature  (°F) 

39 

41 

Minimum  temperature  (°F) 

42 

44 

Maximum  relative  humidity  (percent) 

45 

47 

Minimum  relative  humidity  (percent) 

48 

50 

Season  code 

51 

Precipitation  duration  (hrs) 

52 

53 

Precipitation  amount  (inches) 

54 

57 

Lightning  activity  level 

58 

60 

Relative  humidity  variable^ 

61 

Forecast  flag 

79 

Region  number 

80 

^Relative  humidity  Indicator:  1  =  wet  bulb  temp.,  2  =  RH%,  3  =  dew  point  temp. 


PCDANGER  NFDR  Components  and  indexes  file  format  is  as  follows: 

Field  description  Begin  column         End  column 


Station  ID 

1 

6 

Year 

7 

8 

Month 

9 

10 

Day 

11 

12 

NFDR  mode!  system 

13 

14 

Fuel  model 

15 

Slope  class 

16 

Herbaceous  type 

17 

Climate  class 

18 

Woody  type 

19 

1-hr=  10-hr 

20 

Woody  fuel  moisture  (percent) 

21 

24 

Herbaceous  fuel  moisture  (percent) 

25 

28 

1-hrfuel  moisture  (percent) 

29 

31 

10-hr  fuel  moisture  (percent) 

32 

34 

100-hr  fuel  moisture  (percent) 

35 

37 

1 ,000-hr  fuel  moisture  (percent) 

38 

40 

Keetch-Byram  Drought  Index 

41 

44 

Ignition  component 

45 

48 

Lightning  risk 

49 

52 

Lightning-caused  occurrence  index 

53 

56 

Human  risl< 

57 

60 

Human-caused  occurrence  index 

61 

64 

Spread  component 

65 

68 

Energy  release  component 

69 

72 

Burning  index 

73 

76 

Fire  load  index 

77 

80 

Staffing  class 

81 

84 

Adjective  rating 

85 

87 

Industrial  precautions  class 

88 

90 
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Appendix  C:  Programs  Using  Historical  Fire  and  Weather  Information 


Category 


Name 


Short  description 


Description 


Reference 


Fire  and  weather  data  FIRESTAT 


NIFMID 


Data  access 


KCFAST 


KCFASTPC 


Fire  Statistics  (FS  Fire 
Report  5100-29) 


National  Interagency 
Fire  Management 
Integrated  Database 


Kansas  City  Fire  Access 
Software 


Kansas  City  Fire  Access 
Software  (PC) 


Electronic  entry  and  storage  of  information  from  USDA  Forest 
the  Forest  Service  FS-51 00-29  Individual  Fire  Service  1996b 

Report  form.  Files  are  periodically  transmitted 
to  the  NIFMID  data  base. 

ORACLE  database  on  the  USDA  National  USDA  Forest 

Computer  Center  in  Kansas  City  (NCC-KC)  Service  1993 

which  stores  historical  data  on  weather  (all 
agencies)  and  wildfire  occurrence  (currently 
only  Forest  Service). 

Forest  Service  DG  program.  Utility  to  facilitate  USDA  Forest 

access  to  fire  related  data  and  applications  Service  1996a 

at  the  NCC-KC.  It  is  used  to  extract  fire  and 
weather  data  from  NIFMID  and  to  get  the 
passing  file  of  weather  and  indexes  produced 
by  FIRDAT  (+  other  uses  not  related  to  FIRES). 

PC  program  for  access  to  NCC-KC.  Subset 
of  KCFAST.  Uses  SIMPC  communications 
software  to  interface  with  NCC-KC. 


NFDRS  calculation 
from  daily  weather 


WIMS 

(NFDRCALC) 


NFDRS  daily  calculation 
on  WIMS  at  NCC-KC 


Calculation  of  NDFRS  indexes  from  daily  entry 
of  weather  data  via  WIMS:  Weather  Information 
Management  System.  Weather  is  archived  in 
the  NIFMID  data  base. 


USDA  Forest 
Service  1995 


PCDANGER 


NFDRS  daily  calculation 
(PC) 


Calculation  and 
analysis  of 
NFDRS  from 
historical  weather 


Analysis  of  fire  and 
NFDRS  data 


FIRDAT 

PCFIRDAT 
FIRES 


Groups  of  programs  FIREFAMILY 


PCFIREFAMILY 


WIMS 


NFDRS  historical 
calculation 


NFDRS  historical 
calculation  (PC) 

Fire  Information  Retrieval 
and  Information  System 


Family  of  fire  danger  rating 
programs  for  analysis  of 
historical  data 

FIREFAMILY  programs 
for  PC 

Weather  Information 
Management  System 


Calculation  of  NFDRS  indexes  from  daily  entry 
of  weather  data  on  PC.  Weather  data  can  be 
periodically  transmitted  to  the  NIFMID  data  base 
for  archival.  PCDANGER  is  based  on  the  same 
NFDRS  calculations  as  NFDRCALC,  but  is 
designed  for  PC  and  offers  additional  options. 
Weather  scenarios  can  be  entered  for  medium 
range  projection  of  NFDRS  indexes. 

FIRDAT  is  one  of  the  programs  under  the 
FIREFAMILY  name.  Calculation  of  fire  danger 
indexes  from  archived  weather  files  from  NIFMID. 
A  "passing  file"  containing  weather  and  index 
values  for  each  day  is  created. 

PC  version  of  FIRDAT.  Very  few  changes  to 
design. 

Merges  fire  and  weatherAindex  files  for  analysis. 
Provides  summaries,  plots,  and  analyses  and 
aids  in  determining  most  representative  weather 
station(s),  fuel  model,  and  index  for  setting 
staffing  levels. 

FIRDAT — calculation  of  indexes. 

SEASON— plots  of  data  generated  by  FIRDAT. 

Very  few  changes  to  design.  PCFIRDAT  and 
PCSEASON. 

Programs  and  data  bases  at  NCC-KC  including 
NFDRCALC  and  NIFMID.  FIREFAMILY 
programs  can  be  accessed  through  WIMS  by 
KCFAST  utility. 


This  publication 


Main  and 
others  1 990 


California  Dept. 
of  Forestry  1 994 

Andrews  and 
Bradshaw, 
in  preparation 


Main  and 
others  1 990 

California  Dept. 
of  Forestry  1 994 

USDA  Forest 
Service  1995 
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Appendix  D:  PCDANGER  Source  Code 


PCDANGER  has  been  compiled  with  Microsoft  Fortran,  Version  5.1.  The  distribution  disk  contains  a 
subdirectory  (FDR_SRC)  that  contains  fully  documented  source  code  salient  to  the  computation  of  NFDRS  fuel 
moistures  and  indexes.  The  menu  and  data  screen  routines  are  PC  implementations  of  the  Forest  Service 
Applications  Toolkit  (FSAT)  that  provide  a  "CEO  look  and  feel"  to  application  software  on  the  Forest  Service  Data 
General  systems.  The  graphing  routines  use  libraries  from  a  third-party  vendor.  The  FSAT  and  Graphic  libraries 
are  not  included  in  the  source  code  files. 

To  extract  the  source  code  fi"om  the  FDR_SCR  subdirectory,  type  and  enter: 

A:  \  FDR_SRC  \  SRC_SEND 

The  source  code  files  are  expanded  from  drive  a:  into  your  current  working  directory.  The  source  code  files  are 
internally  documented.  The  files  contained  in  SRC_SEND,  and  a  brief  description  of  their  function  follows.  Files 
with  a  .FOR  extension  contain  multiple  routines  (functions)  collected  in  a  function  related  file.  Files  with  an  .INC 
extension  are  'include'  files  that  define  variables  contained  in  labeled  common  blocks. 


FDR.FOR 

STN_CAT.FOR 

STN_FCST.FOR 

STN_OB.FOR 

CURING.FOR 

NFDRCALC.FOR 

READ_WX.FOR 

CATALOG.INC 

STN_COMS.INC 

FCST_COM.INC 

WX_CAT.INC 

WX_COMS.INC 

WX_OBS.INC 

FDR_FUEL.INC 
NDX  COMS.INC 


Main  Program  and  data  initialization  routines. 

Does  all  station  catalog  data  entry  and  validation. 

Does  all  weather  forecast  data  entry  and  validation. 

Does  all  weather  observation  data  entry  gind  validation. 

Live  fuel  moisture  computations. 

Dead  fuel  moisture  and  index  computations. 

Reads  weather  observations  from  files. 

Include  file  defining  all  variables  in  the  station  catalog  file  structure. 
Include  file  defining  pointers  into  station  catalog  screen. 
Include  file  defining  pointers  into  forecast  screen. 

Include  file  defining  station  catalog  objects  needed  for  NFDR  computaions. 
Include  file  defining  pointers  into  weather  observations  screen. 

Include  file  defining  weather  elements  (observed  or  forecasted)  for  weather  observations  into 

NFDRCALC. 
Include  file  for  fuel  model  parameters. 

Include  file  defining  index  structure  for  passing  between  routines. 
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ix  E:  Software  Availability 


You  may  obtain  a  current  version  of  PCDANGER  software  from  the  National 
Fire  and  Aviation  Management  (F&AM)  Support  Helpdesk.  You  may  also 
download  it  from  the  USDA  Forest  Service  Weather  Information  Management 
System  (WIMS).  Contact  information  is: 

F&AM 

DG  Message:  FIRE?:W02A 

E-Mail:  /s=FIRE?/oul=W02a@mhs-fswa.attmail.com 

Telephone:  1-800-253-5559 

WIMS 

SFILE  FORMS 

Filename  FDR_SEND.EXE  (Self-Extracting  Distribution  File) 
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used  in  the  Weather  Information  Management  System  (WIMS),  which  is  the  current  national 
system  in  the  United  States  for  daily  computation  of  NFDRS  components  and  indexes. 
PCDANGER  replaces  the  former  PC-based  fire  danger  rating  application  NFDRSPC. 
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public  and  private  organizations,  and  individuals.  Results  of  research  are  made  available  through  publica- 
tions, symposia,  workshops,  training  sessions,  and  personal  contacts. 
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